home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1999 #1 / Amiga Plus 1999 #1.iso / System-Boost / Workbench / WindowToFront / DocsItaliano / WindowToFront.doc next >
Text File  |  1998-06-17  |  27KB  |  558 lines
  1.  
  2.  
  3.                             WINDOWTOFRONT 1.6
  4.  
  5.             dedicato alla memoria di Jay G. Miner (1932-1994)
  6.  
  7.  
  8.    ATTENZIONE: WindowToFront richiede l'AmigaOS Release 2 (o superiori).
  9.  
  10.  
  11.    INTRODUZIONE
  12.  
  13.    WindowToFront è una commodity scritta allo scopo di sostituire l'originale
  14. programma "ClickToFront" che viene fornito con tutti gli Amiga.
  15.  
  16.    Perchè sostituirlo? Il motivo principale è stato che trovo estremamente
  17. fastidioso il modo in cui ClickToFront insiste nel portare in primo piano
  18. qualsiasi finestra del Workbench ogni volta che l'utente fa doppio click su
  19. un'icona. Ciò potrebbe essere ancora tollerabile con le finestre dei volumi
  20. o quelle dei cassetti, ma diventa inaccettabile nel caso della finestra
  21. Workbench principale: quando è portata in primo piano, essa finisce per
  22. ricoprire quasi l'intero schermo.
  23.    Inoltre pensavo che il programma potesse trarre beneficio da alcune
  24. caratteristiche aggiuntive e dall'avere una vera interfaccia utente grafica
  25. piuttosto che dover essere configurato tramite la finestra Informazioni della
  26. sua icona. Così ho scritto WindowToFront.
  27.  
  28.    WindowToFront permette di portare in primo piano qualsiasi finestra non
  29. backdrop con un numero a scelta di click del mouse su di essa e di portarla
  30. sullo sfondo in vari modi; è inoltre possibile scegliere un numero di click
  31. diverso per tre tipi distinti di finestra e uno anche per il bordo delle
  32. finestre.
  33.  
  34.    Tutte le opzioni sono selezionabili con un pannello di controllo o con i
  35. tool type; WindowToFront può essere lanciato sia da Shell che da Workbench,
  36. può salvare nella sua icona la configurazione preferita e può essere adattato
  37. a qualsiasi lingua tramite un apposito file .catalog per la localizzazione.
  38.  
  39.  
  40.    1. INSTALLAZIONE
  41.  
  42.    L'installazione di WindowToFront è molto semplice: basta lanciare lo
  43. script apposito facendo doppio click sull'icona "Install".
  44.  
  45.    Se tuttavia preferite installarlo manualmente, tutto ciò che dovete
  46. fare è copiare il programma insieme alla sua icona nel vostro cassetto
  47. SYS:Tools/Commodities, e aggiungere la riga seguente alla vostra User-startup:
  48.  
  49.    Run > NIL: WindowToFront
  50.  
  51.    In alternativa potete semplicemente metterlo nel vostro cassetto WBStartup.
  52.  
  53.    Inoltre, se volete usare WindowToFront in una lingua diversa dall'inglese,
  54. potete localizzarlo come spiegato nel paragrafo 6, "Localizzazione".
  55.  
  56.  
  57.    2. USO DA SHELL
  58.  
  59.    Per conoscere il template di WindowToFront da Shell, è sufficiente dare
  60. il tipico
  61.  
  62.    WindowToFront ?
  63.  
  64.    Il template, comunque, è il seguente:
  65.  
  66.    CX_PRIORITY/N/K,CX_POPKEY/K,CX_POPUP/K,CLICKS/N/K,CLICKS_WB/N/K,
  67. CLICKS_WBWIN/N/K,CLICKS_BORDER/N/K,CLICKS_BACK/N/K,QUALIFIER/K,
  68. QUALIFIER_BACK/K,WBONLY/K,AUTOBACK/K,ACTIVATEBACK/K,HOTKEY_BACK/K,BACKMODE/K,
  69. LANGUAGE/K,GADGETS/K,FORCETOPAZ/K:
  70.  
  71.    Le keyword che compaiono qui corrispondono esattamente ai tool types
  72. che si possono inserire nell'icona di WindowToFront. Vediamone il
  73. significato e i valori di default:
  74.  
  75.    CX_PRIORITY=<num>           [default: 0]
  76.    CX_POPKEY=<hotkey>          [default: CTRL w]
  77.    CX_POPUP=<YES | NO>         [default: NO]
  78.  
  79.    Questi tre sono comuni a tutte i programmi di Commodities Exchange.
  80. Permettono di specificare la priorità di WindowToFront rispetto alle altre
  81. Commodity (il default è consigliato), la sequenza di tasti che fa
  82. comparire il pannello di controllo quando è nascosto, e se il pannello
  83. debba comparire subito appena si lancia il programma oppure rimanere
  84. nascosto fino al momento in cui venga richiamato tramite la hotkey.
  85.  
  86.    CLICKS=<numero di click>           [default: 2]
  87.  
  88.    Questo permette di scegliere il numero di click che serviranno per
  89. portare in primo piano una finestra "normale", cioè una che non sia nè
  90. quella principale del Workbench nè quella di un dischetto o cassetto del
  91. Workbench (una che non possa contenere icone, insomma).
  92.    Il numero di click selezionabile varia da 1 a 4. In ogni caso un solo
  93. click è fortemente sconsigliato poiché crea parecchia confusione.
  94.    Indicando 0 come numero di click si disattiva questa funzione.
  95.  
  96.    CLICKS_WB=<numero di click>        [default: 2]
  97.  
  98.    Questo permette di scegliere il numero di click per portare in primo
  99. piano la finestra principale del Workbench, cioè quella in cui appaiono le
  100. icone dei dischetti. Questo è possibile solo se la finestra non è stata
  101. resa backdrop. Potete tranquillamente scegliere 2 per questa opzione, in
  102. quanto un doppio click su un'icona del Workbench, se quest'ultima è di tipo
  103. DISK, DRAWER o TRASHCAN, non porta la finestra in primo piano.
  104.    Con altri tipi di icone (ad esempio AppIcon) in certi casi può ancora
  105. succedere che la finestra venga portata in primo piano: se vi trovate spesso
  106. in questa situazione, potete ad esempio indicare 3 come valore per questo
  107. parametro.
  108.    Indicando 0 come numero di click si disattiva questa funzione.
  109.  
  110.    CLICKS_WBWIN=<numero di click>     [default: 2]
  111.  
  112.    Con questo si specifica il numero di click per le finestre del Workbench
  113. associate ad un disco o ad un cassetto. Queste finestre solitamente sono
  114. più piccole dell'intero schermo per cui non è molto fastidioso se una di
  115. esse viene involontariamente portata in primo piano facendo doppio click
  116. su una sua icona; ad ogni modo nella maggior parte dei casi questo non
  117. succederà (di sicuro non accadrà se si fa doppio click su un cassetto o sul
  118. Trashcan).
  119.    Indicando 0 come numero di click si disattiva questa funzione.
  120.  
  121.    CLICKS_BORDER=<numero di click>    [default: 2]
  122.  
  123.    Questo permette di indicare il numero di click per portare in primo
  124. piano una qualsiasi finestra quando il puntatore si trova sul suo bordo o
  125. sulla barra del titolo (esclusi i gadget di sistema).
  126.    Indicando 0 come numero di click NON si disattiva la funzione, ma si
  127. specifica che il numero di click da usare per il bordo è lo stesso definito
  128. per l'interno della finestra (differenziando così fra i tre tipi di
  129. finestra). Diversamente il numero di click per il bordo è lo stesso per
  130. tutti i tipi di finestra.
  131.  
  132.    CLICKS_BACK=<numero di click>      [default: 1]
  133.  
  134.    Con questo si indica il numero di click che serviranno a portare sullo
  135. sfondo una qualsiasi finestra quando si premerà contemporaneamente il tasto
  136. (o insieme di tasti) indicati dal QUALIFIER_BACK (vedi oltre).
  137.    Poiché per questa operazione è necessario (di solito) un qualificatore,
  138. non ci sono problemi ad indicare 1 come numero di click: anzi, è la scelta
  139. più comoda.
  140.    Indicando 0 come numero di click si disattiva questa funzione.
  141.  
  142.    QUALIFIER=<qualificatore>          [default: NONE (NESSUNO)]
  143.  
  144.    Il qualificatore è quel tasto o quell'insieme di tasti (come ad esempio
  145. CTRL ALT) che deve essere premuto mentre si fa click sulle finestre
  146. affinchè la funzione di portarle in primo piano venga effettivamente
  147. svolta.
  148.    Poiché nella maggior parte dei casi dover premere uno o più tasti
  149. insieme al pulsante del mouse comporta un rallentamento delle operazioni
  150. (dell'utente, non del computer), si consiglia di indicare NONE per questa
  151. opzione (o NESSUNO se avete localizzato WindowToFront in italiano).
  152.  
  153.    QUALIFIER_BACK=<qualificatore>     [default: LALT]
  154.  
  155.    Questo qualificatore, invece, è indispensabile per poter distinguere
  156. tra click effettuati per portare una finestra in primo piano e click
  157. effettuati per mandarla sullo sfondo.
  158.    Se le due operazioni richiedessero lo stesso qualificatore e un uguale
  159. numero di click, l'operazione di portare la finestra in primo piano avrebbe
  160. sempre la precedenza sull'altra (sarebbe l'unica ad essere eseguita).
  161.    Nota: fino alla versione 1.1 il comportamento del programma in questo
  162. caso era esattamente l'opposto!
  163.    Se invece il numero di click assegnato alle due operazioni è diverso,
  164. a parità di qualificatore viene eseguita prima l'operazione che richiede
  165. meno click. Proseguendo a fare click con il mouse viene poi eseguita anche
  166. l'altra.
  167.    Ad esempio potete specificare NONE per entrambi i qualificatori e
  168. assegnare 3 come numero di click per portare le finestre sullo sfondo:
  169. facendo tre volte click su una finestra, questa verrà dapprima portata in
  170. primo piano e subito dopo sullo sfondo. Questo può essere un modo per
  171. evitare l'uso di un qualificatore, che può a volte risultare scomodo.
  172.    Il qualificatore per lo sfondo di default è il tasto ALT di sinistra.
  173.    Sconsiglio l'uso dei tasti di SHIFT che vengono già gestiti dal Workbench
  174. e dei tasti AMIGA che hanno un significato speciale per Intuition.
  175.    Questo significa che i tasti più adatti a svolgere questo compito sono i
  176. due ALT e CTRL.
  177.  
  178.    Nota sui qualificatori: indicando separatamente due tasti analoghi,
  179. come ad esempio "LALT RALT", sarà richiesta la pressione CONTEMPORANEA di
  180. questi tasti. Specificando invece solo la loro parte comune, come ad
  181. esempio "ALT" sarà sufficiente premere uno qualsiasi dei due per svolgere
  182. l'operazione associata.
  183.    Inoltre la parola NONE è valida qualunque sia la lingua di localizzazione
  184. di WindowToFront, mentre i sinonimi nelle altre lingue, come NESSUNO, sono
  185. riconosciuti solo se viene utilizzato il file .catalog corrispondente.
  186.    Vedere inoltre il paragrafo 5 per una lista completa dei nomi
  187. utilizzabili per i qualificatori.
  188.  
  189.    WBONLY=<YES | NO>                  [default: YES]
  190.  
  191.    Normalmente (per default) WindowToFront svolge la sua funzione solo con
  192. le finestre che appaiono sullo schermo Workbench (o sullo schermo PUBLIC di
  193. default). Specificando NO qui si ottiene che il programma operi sulle
  194. finestre di tutti gli schermi. In certi casi questo può creare contrasti
  195. con le operazioni dei programmi che hanno aperto tali schermi ma di solito
  196. non ci sono particolari problemi.
  197.    Attenzione: per questo tool type e tutti gli altri analoghi (YES/NO)
  198. qualsiasi indicazione diversa da "NO" (anche una stringa nulla come ad
  199. esempio "AUTOBACK=" oppure "WBONLY") verrà interpretata come YES.
  200.  
  201.    AUTOBACK=<YES | NO>                [default: NO]
  202.  
  203.    La specifica di YES qui indica che facendo il numero di click scelto
  204. per portare una finestra in primo piano su una finestra che è già in primo
  205. piano (cioè non è coperta da altre in nessuna sua parte) questa sarà
  206. mandata sullo sfondo. Se invece la finestra è parzialmente oscurata verrà
  207. portata in primo piano come al solito.
  208.  
  209.    ACTIVATEBACK=<YES | NO>            [default: NO]
  210.  
  211.    Normalmente una finestra che viene mandata sullo sfondo è una finestra
  212. che al momento non si desidera usare, per cui non c'è alcun motivo di
  213. attivarla durante questa operazione. Infatti per default WindowToFront non
  214. attiverà le finestre mandate sullo sfondo in modo normale (cioè tramite la
  215. combinazione QUALIFIER_BACK + CLICKS_BACK), anche se lo farà nel caso di
  216. finestre "allontanate" con la modalità AUTOBACK. Specificando YES qui si
  217. farà in modo che WindowToFront attivi sempre le finestre che manda sullo
  218. sfondo (per quanto la ragione di una simile scelta sarebbe del tutto al
  219. di là della mia comprensione...).
  220.  
  221.    HOTKEY_BACK=<hotkey>               [default: LALT ESC]
  222.  
  223.    Con questa keyword si specifica la combinazione di tasti che fa sì che
  224. la finestra corrente venga mandata sullo sfondo. Quale sia la finestra
  225. corrente dipende dal valore che viene assegnato alla keyword BACKMODE.
  226.    La combinazione di tasti di default è ALT sinistro + ESC.
  227.  
  228.    BACKMODE=<POINTER | ACTIVE>        [default: POINTER]
  229.  
  230.    Questa keyword viene usata per indicare quale finestra deve essere
  231. mandata sullo sfondo nel caso venga premuta la combinazione di tasti
  232. indicata con HOTKEY_BACK.
  233.    Specificando POINTER verrà mandata sullo sfondo la finestra che si
  234. trova sotto il puntatore del mouse, indicando invece ACTIVE la finestra
  235. allontanata sarà quella attiva.
  236.  
  237.    LANGUAGE=<lingua>                  [default: locale]
  238.  
  239.    Con questa keyword si indica quale lingua debba essere utilizzata per
  240. la localizzazione (adattamento ad una particolare lingua) di WindowToFront.
  241.    Affinché questo possa avvenire, è necessario che l'appropriato file
  242. .catalog per quella lingua si trovi nella sua directory, come verrà spiegato
  243. più dettagliatamente nel paragrafo 6, "Localizzazione".
  244.    Non è necessario disporre della locale.library per effettuare la
  245. localizzazione.
  246.  
  247.    GADGETS=<YES | NO>                 [default: NO]
  248.  
  249.    Con questa opzione si può indicare se si desidera che il pannello
  250. di controllo di WindowToFront presenti in basso i due gadget "Hide" e
  251. "Quit" ("Nascosto" e "Fine" per l'italiano).
  252.    Questi non sono necessari, poiché queste due opzioni sono già presenti
  253. nel menu "Project" ("Progetto") e la loro eliminazione permette di
  254. risparmiare spazio avendo una finestra più bassa, ma la loro presenza
  255. potrebbe essere una comodità irrinunciabile per alcuni.
  256.  
  257.    FORCETOPAZ=<YES | NO>              [default: NO]
  258.  
  259.    A partire dalla versione 1.2 WindowToFront presenta un'interfaccia utente
  260. font-sensitive (che cioè si adatta al font usato per il Workbench). Chi
  261. volesse, per qualche motivo, continuare ad usare il font topaz 8, potrà farlo
  262. specificando YES come valore per questa keyword.
  263.  
  264.  
  265.    3. USO DA WORKBENCH
  266.  
  267.    L'uso da Workbench è analogo a quello di tutte le altre Commodity: è
  268. sufficiente far partire il programma con un doppio click sulla sua icona.
  269. Questa operazione provocherà la comparsa del pannello di controllo se tra i
  270. tool type dell'icona è compreso "CX_POPUP=YES", altrimenti il programma
  271. comincerà a girare "silenziosamente" in sottofondo.
  272.    Per far comparire il pannello di controllo sarà allora necessario
  273. premere la combinazione di tasti specificata tramite il tool type
  274. "CX_POPKEY" (sempre nell'icona).
  275.    Con la voce "Information..." del menu "Icons" del Workbench si possono
  276. aggiungere, cancellare e modificare i tool type dell'icona di WindowToFront.
  277.    Alternativamente, dopo aver modificato i parametri di funzionamento di
  278. WindowToFront per mezzo del pannello di controllo, è possibile salvare tali
  279. parametri nell'icona del programma con la voce "Save" ("Salva") del menu
  280. "Project" ("Progetto"). Tuttavia alcuni parametri, come ad esempio
  281. "CX_POPUP", non possono essere modificati in questo secondo modo.
  282.    I tool type riconosciuti da Workbench e i loro possibili valori sono
  283. esattamente gli stessi descritti nel paragrafo "Uso da Shell".
  284.    Trasferendo WindowToFront nel cassetto "WBStartup" (con la sua icona)
  285. il programma sarà lanciato automaticamente ad ogni reboot. In questo caso è
  286. necessario avere "DONOTWAIT" tra i tool type dell'icona, poiché
  287. WindowToFront, come le altre Commodity standard, non è self-detaching.
  288.  
  289.  
  290.    4. IL PANNELLO DI CONTROLLO
  291.  
  292.    Non sarebbe davvero necessario descrivere l'uso del pannello di
  293. controllo, data la sua intuitività, comunque esaminiamo sommariamente i
  294. vari gadget e menu. Per indicarli userò il nome in italiano.
  295.  
  296.    "Richiamo:" - Permette di modificare la hotkey (combinazione di tasti)
  297. che serve a far comparire il pannello di controllo. Se si inserisce qui
  298. un'espressione scorretta verrà ripristinato il contenuto precedente del
  299. gadget (dopo aver premuto RETURN). Attenzione: lettere maiuscole come "W"
  300. sottintendono una pressione contemporanea di un tasto SHIFT.
  301.  
  302.    "Autore..." - Provoca la comparsa di un requester con alcune
  303. informazioni sul programma e sull'autore.
  304.  
  305.    "Finestre normali:" - Questo slider permette di variare il numero di
  306. click da usare per portare in primo piano le finestre "normali" (quelle che
  307. non fanno parte del Workbench e non contengono icone). La modifica avviene
  308. in tempo reale, cioè non è necessario chiudere il pannello di controllo per
  309. renderla operativa.
  310.  
  311.    "Finestra principale WB:" - Come sopra, riferito però alla finestra
  312. principale del Workbench, cioè quella in cui compaiono le icone dei
  313. dischetti, delle partizioni dell'hard disk, delle Ram/Rad Disk, ecc.
  314.  
  315.    "Finestre Workbench:" - Come sopra, ma riferito alle altre finestre del
  316. Workbench (es. cassetti).
  317.  
  318.    "Bordo finestre:" - Come sopra, ma riferito al bordo di qualsiasi
  319. finestra. Portando questo slider su "Off" si ottiene che il numero di click
  320. da usare sul bordo sia lo stesso da usare all'interno delle finestre.
  321.  
  322.    "Manda sullo sfondo:" - Con questo slider si specifica il numero di
  323. click da usare per mandare le finestre sullo sfondo (quando è premuto
  324. contemporaneamente il qualificatore associato a questa operazione).
  325.  
  326.    "Solo Workbench:" - Questo checkbox permette di scegliere se
  327. WindowToFront debba operare sulle finestre di tutti gli schermi oppure solo
  328. su quelle dello schermo Workbench.
  329.  
  330.    "AutoSfondo:" - Checkbox per attivare/disattivare la modalità AUTOBACK
  331. (vedi il paragrafo "Uso da Shell").
  332.  
  333.    "Attiva su sfondo:" - Checkbox per indicare se attivare o no le finestre
  334. che si mandano sullo sfondo. Questo gadget sarà disabilitato nel caso in cui
  335. il numero di click per mandare le finestre sullo sfondo sia 0 (Off) oppure
  336. sia 1 e non sia stato indicato alcun qualificatore per l'operazione di
  337. mandare sullo sfondo.
  338.    In quest'ultimo caso infatti è necessario attivare sempre la finestra
  339. su cui si fa click, altrimenti nessuna finestra potrà mai essere attivata
  340. (almeno nel modo consueto, cioè con un singolo click senza qualificatori).
  341.  
  342.    "Primo piano:" - Questo gadget stringa contiene il qualificatore per
  343. l'operazione "Porta la finestra in primo piano". Immettendo (con RETURN) un
  344. qualificatore non valido verrà ripristinato il valore precedente.
  345.    Immettendo una stringa nulla verrà visualizzato NONE (NESSUNO) o il
  346. corrispondente termine nella lingua usata. È possibile usare direttamente
  347. tale termine oppure NONE (sempre valido con qualsiasi lingua) per indicare
  348. appunto che non deve essere richiesto alcun qualificatore per l'operazione
  349. in questione.
  350.  
  351.    "Sfondo:" - Esattamente come sopra, ma riferito all'operazione "Manda
  352. la finestra sullo sfondo". Generalmente è meglio non indicare NONE qui.
  353.  
  354.    "Tasti:" - Questo gadget stringa contiene la combinazione di tasti che
  355. deve provocare l'azione "manda la finestra sullo sfondo". Immettendo un
  356. valore scorretto seguito da RETURN, verrà ripristinato il valore precedente.
  357.  
  358.    "Modo:" - Questo cycle gadget è usato per scegliere quale finestra sarà
  359. portata sullo sfondo premendo la combinazione di tasti di cui sopra. Il
  360. valore "Sotto puntatore" significa che la finestra in questione sarà quella
  361. che si trova, appunto, sotto il puntatore del mouse, mentre il valore
  362. "Finestra attiva" indica che la finestra mandata sullo sfondo sarà quella
  363. attiva.
  364.  
  365.    "Nascosto" - Questo gadget è presente solo se si è indicato il tool type
  366. GADGETS=YES alla chiamata di WindowToFront (sulla linea di comando o
  367. nell'icona). La sua funzione è quella di fare sparire il pannello di
  368. controllo mantenendo WindowToFront attivo in sottofondo. Si può ottenere lo
  369. stesso effetto premendo il tasto "N" (o un altro tasto in base alla lingua
  370. usata, come indicato nel file .catalog).
  371.    Per richiamare il pannello occorre premere il richiamo (hotkey).
  372.  
  373.    "Fine" - Questo gadget è presente solo se si è indicato il tool type
  374. GADGETS=YES alla chiamata di WindowToFront (sulla linea di comando o
  375. nell'icona). La sua funzione è quella di terminare l'esecuzione di
  376. WindowToFront e rimuoverlo dalla memoria. Si può ottenere lo stesso effetto
  377. premendo il tasto "F" (o un altro tasto in base alla lingua usata, come
  378. indicato nel file .catalog).
  379.  
  380.    "Salva" (Menu Progetto) - Selezionando questa voce di menu si salva la
  381. configurazione corrente (hotkey, numero di click, opzioni, qualificatori,
  382. ecc.) nell'icona di WindowToFront. Se questa non esiste, il programma la
  383. creerà prima.
  384.  
  385.    "Nascosto" (Menu Progetto) - Questa voce di menu ha la stessa funzione
  386. del gadget omonimo (vedi).
  387.  
  388.    "Fine" (Menu Progetto) - Questa voce di menu ha la stessa funzione del
  389. gadget omonimo (vedi).
  390.  
  391.    Occorre ricordare infine che il gadget di chiusura della finestra di
  392. WindowToFront ha lo stesso effetto del menu (gadget) "Nascosto".
  393.  
  394.  
  395.    5. QUALIFICATORI RICONOSCIUTI DALLA COMMODITIES.LIBRARY
  396.  
  397.    Questa è una lista dei qualificatori riconosciuti dalla versione 37 (e
  398. superiori) della commodities.library ed utilizzabili con WindowToFront.
  399.  
  400.    QUALIFICATORE           SIGNIFICATO
  401.  
  402.    LCOMMAND                Tasto AMIGA di sinistra
  403.    RCOMMAND                Tasto AMIGA di destra
  404.    LSHIFT                  Tasto SHIFT di sinistra
  405.    RSHIFT                  Tasto SHIFT di destra
  406.    LALT                    Tasto ALT di sinistra
  407.    RALT                    Tasto ALT di destra
  408.    CAPSLOCK                Tasto Caps Lock
  409.    CONTROL                 Tasto CTRL
  410.    SHIFT                   Un qualsiasi tasto SHIFT
  411.    CAPS                    Un qualsiasi tasto SHIFT oppure Caps Lock
  412.    ALT                     Un qualsiasi tasto ALT
  413.  
  414.    Nota: a partire dalla versione 38 (OS 2.1) della commodities.library
  415. sono stati aggiunti numerosi sinonimi per questi qualificatori, che non è
  416. comunque necessario elencare qui. Se possedete il sistema operativo 2.1 o
  417. 3.x dovreste trovarli riportati sul manuale del software di sistema.
  418.  
  419.  
  420.    6. LOCALIZZAZIONE
  421.  
  422.    Di default WindowToFront comunica con l'utente in lingua inglese, ma
  423. naturalmente il programma può essere localizzato, cioè adattato ad una
  424. lingua specifica.
  425.  
  426.    A partire dalla versione 1.2 WindowToFront può essere localizzato solo
  427. utilizzando gli appositi file .catalog contenenti le stringhe tradotte nelle
  428. varie lingue. Il programma è in grado di interpretare tali file anche in
  429. assenza della locale.library, anche se in futuro questo supporto potrebbe
  430. essere rimosso in quanto ridondante.
  431.  
  432.    Se avete installato WindowToFront usando lo script di installazione
  433. fornito probabilmente avrete già scelto la vostra lingua preferita e il
  434. file .catalog appropriato sarà già stato copiato nel suo luogo corretto.
  435. In caso contrario, o se volete installare altri file .catalog, ecco come
  436. procedere.
  437.  
  438.    Non dovete fare altro che copiare il file "windowtofront.catalog" per
  439. la vostra lingua, se fornito, nella directory LOCALE:Catalogs/<nomelingua>,
  440. dove <nomelingua> è il nome della vostra lingua locale. Per esempio, un
  441. italiano potrebbe copiare il file "Catalogs/italiano/windowtofront.catalog"
  442. (che si trova nella directory di distribuzione di WindowToFront) nella
  443. directory "LOCALE:Catalogs/italiano/" del suo sistema, ottenendo così il
  444. file di localizzazione "LOCALE:Catalogs/italiano/windowtofront.catalog".
  445.  
  446.    Anche se avete la locale.library, non è necessario che selezioniate la
  447. vostra lingua preferita con l'editor Locale delle preferences: potete
  448. indicarla direttamente a WindowToFront con la keyword (o tool type) LANGUAGE.
  449.    Se volete che il programma si adegui alla lingua locale scelta con
  450. l'editor, indicate semplicemente "locale" come valore della suddetta keyword.
  451.  
  452.    In ogni caso le dimensioni del pannello di controllo e la posizione dei
  453. gadget saranno adattate alla lunghezza delle stringhe utilizzate.
  454.  
  455.    Con la versione 1.6 di WindowToFront sono forniti ufficialmente i file
  456. .catalog per la lingua inglese e per quella italiana; in futuro vedrò di
  457. aggiungerne altri (se qualcuno li scrive per me, cioè).
  458.  
  459.    Potete realizzare una versione del file .catalog per la vostra lingua
  460. usando il programma per sviluppatori "CatComp" con il file .cd fornito:
  461. se siete sviluppatori dovreste già sapere come fare. Alternativamente potete
  462. utilizzare uno dei tanti programmi PD che svolgono questa operazione
  463. modificando un file .catalog già esistente.
  464.  
  465. NOTA: Se realizzate versioni per altre lingue del file .catalog, siete
  466. liberi (e, anzi, invitati a farlo) di inviarmele per via telematica, in
  467. modo che io possa includerle in una futura distribuzione di WindowToFront.
  468. Potete anche diffonderle separatamente, sempre naturalmente nel pubblico
  469. dominio.
  470.  
  471.  
  472.    7. NOTE IMPORTANTI
  473.  
  474.    WindowToFront rimane inattivo quando l'utente seleziona un gadget
  475. all'interno di una finestra. Alcuni programmi gestiscono privatamente un
  476. doppio click sui loro gadget, quindi non è il caso che WindowToFront
  477. interferisca con essi.
  478.    Inoltre WindowToFront non porta in primo piano le finestre backdrop.
  479.  
  480.    In generale specificare un solo click senza alcun qualificatore per
  481. qualunque operazione provoca confusione e notevoli problemi di gestione
  482. delle finestre (da parte dell'utente) e di interazione con Intuition.
  483.    Si consiglia, pertanto, di NON farlo.
  484.  
  485.    A partire dalla versione 1.1 WindowToFront è in grado di salvare la
  486. propria configurazione anche se nella sua directory non esiste una icona con
  487. il suo stesso nome; in tal caso infatti il programma creerà una nuova icona
  488. per se stesso.
  489.  
  490.    Infine, per vari motivi che sarebbe troppo lungo spiegare, sconsiglio di
  491. rinominare il programma. In ogni caso "WindowToFront" è il suo nome ufficiale
  492. ed è così che voglio sia conosciuto dagli utenti di Amiga nel mondo (ok,
  493. nessuno fa più queste cose, ma comunque...).
  494.  
  495.  
  496.    8. REVISIONI ESISTENTI
  497.  
  498.    1.6   Ridotto significativamente il consumo di stack; prima poteva
  499.          provocare crash durante l'uso della GUI (grazie a Nils Görs per
  500.          la segnalazione). Inoltre ora l'eseguibile è più corto di 236 byte.
  501.  
  502.    1.5   Migliorata la compatibilità con DirOpus 5 usato come rimpiazzo del
  503.          Workbench (non ancora perfetta, comunque). Aggiunto uno script di
  504.          installazione per stare al passo con i tempi. Documentazione
  505.          riscritta nelle sue parti più antiche. Ricompilato con il SAS/C
  506.          6.58. L'eseguibile è più corto di 88 byte.
  507.  
  508.    1.4   Corretti ulteriori bug. Documentazione parzialmente riscritta (stava
  509.          diventando obsoleta). Ancora più ottimizzato: ora l'eseguibile è più
  510.          corto di 1132 byte.
  511.  
  512.    1.3   Rimossi alcuni bug che provocavano Enforcer hit. L'eseguibile è
  513.          più corto di 92 byte.
  514.          [Nota: questa versione è disponibile solo sul CD-ROM di IPISA '95]
  515.  
  516.    1.2   Completamente riscritto e ottimizzato utilizzando il SAS/C 6.51.
  517.          Aggiunta la possibilità di mandare le finestre sullo sfondo
  518.          tramite una combinazione di tasti (grazie a Federico Chiesa
  519.          per l'eccellente suggerimento). Ora il pannello di controllo
  520.          è completamente font-sensitive. Sotto OS 3.0+ vengono usati
  521.          i menu NewLook. Rimosso il supporto del file di testo per la
  522.          localizzazione: resta solo l'utilizzo dei file .catalog, che
  523.          comunque non richiede la locale.library. Modificato legger-
  524.          mente il comportamento in alcune situazioni. Risolto il problema
  525.          del doppio click sulle icone! Per finire, ora l'eseguibile è più
  526.          corto di 7228 byte.
  527.          [Nota: questa versione è stata rilasciata solo ai beta-tester]
  528.  
  529.    1.1   La localizzazione ora supporta anche la locale.library (e in
  530.          futuro supporterà solo quella). L'estetica del pannello è
  531.          leggermente migliore. Ora WindowToFront è in grado di creare
  532.          la propria icona se questa non esiste durante il salvataggio
  533.          della configurazione. Inoltre aggiunti alcuni messaggi di errore.
  534.          Il requester per le informazioni è ora un EasyRequester. Infine
  535.          l'eseguibile è più corto di 612 byte.
  536.  
  537.    1.0   La versione originale.
  538.  
  539.  
  540.    9. NOTE FINALI
  541.  
  542.    Se scoprite dei bug, avete qualche dubbio oppure volete mandarmi dei
  543. suggerimenti (sempre ben accetti) per le versioni future di WindowToFront,
  544. scrivete a:
  545.  
  546.       Massimo Tantignone
  547.       Via Campagnoli, 4
  548.       28100 NOVARA
  549.       ITALIA
  550.  
  551.       E-mail: tanti@intercom.it
  552.  
  553.    Ed ora, per concludere in modo tradizionale:
  554.  
  555.                //
  556.    Grazie ad \X/ AMIGA per essere TUTTORA il miglior computer che ci sia!
  557.  
  558.